home *** CD-ROM | disk | FTP | other *** search
/ Tools Unlimited 1: The Blanker Collection / Tools Unlimited - Vol 1 - The Blanker Collection.iso / Blanker / Packages / TwilightZone / TZ.DOC < prev    next >
Text File  |  1996-01-25  |  8KB  |  217 lines
  1.  
  2.  
  3.                     * * *  T W I L I G H T   Z O N E  * * *
  4.  
  5.                       version 1.1/2.0, October 10th, 1992
  6.  
  7.                                  User Manual
  8.  
  9.         ***************************************************************
  10.  
  11.                                   Contents
  12.  
  13.                    1. Introduction
  14.                    2. Getting started
  15.                    3. Creating own blanker modules
  16.  
  17.         ***************************************************************
  18.  
  19.  
  20.         1. Introduction
  21.  
  22.  
  23.         What is "Twilight Zone" ?
  24.  
  25.         "Twilight Zone" is a modular screen blanker with a user-friendly
  26.         control panel. In contrast to most ordinary screen blankers
  27.         "Twilight Zone" provides the following features:
  28.  
  29.         * selection of a blanker module out of a list of modules
  30.  
  31.         * "blank now" feature by moving the mouse pointer into a corner
  32.           of the screen
  33.  
  34.         * "blank never" option by moving the mouse pointer into a corner
  35.           of the screen
  36.         
  37.         * time out freely adjustable (quantity, minutes or seconds)
  38.  
  39.         * "wake up event" freely adjustable (mouse, keyboard, disk drive)
  40.  
  41.         With some knowledge in programming it is not difficult to create
  42.         new blanker modules, which can be integrated into "Twilight Zone"
  43.         and displayed in its control panel.
  44.  
  45.  
  46.         Requirements
  47.  
  48.         Version 1.1 of "TwilightZone" was developed and tested with OS 1.3.
  49.         Thus it is no commodity. It was also tested with AmigaOS 2.04.
  50.         Version 2.0 was exclusively developed for OS 2.04. Thus it does
  51.         not need "arp.library" any more. I am going to make it to a
  52.         commodity as soon as possible.
  53.  
  54.  
  55.         ***************************************************************
  56.  
  57.  
  58.         2. Getting started
  59.  
  60.  
  61.         Installation
  62.  
  63.         To install "TwilightZone" double-click the "Install" icon.
  64.         This short shell script will copy the libraries required by
  65.         "TwilightZone" into the LIBS: directory. The program needs
  66.  
  67.         - arp.library (v39.1) (version 1.1 only !) and
  68.         - intuisup.library (v4.5 or higher).
  69.         
  70.         Furthermore, you must have a directory from where "Twilight Zone"
  71.         get its blanker modules. If this directory is not the same as
  72.         the one where the program is placed, you must assign the logical
  73.         device "TZ:" to it.
  74.         When "Twilight Zone" starts, first it looks in the current
  75.         directory for blanker modules. If it cannot find any matching file
  76.         (with the extension ".tz"), it tries to get files from "TZ:".
  77.  
  78.  
  79.         Starting "Twilight Zone"
  80.  
  81.         You can start "Twilight Zone" by double-clicking its icon on
  82.         workbench or by creating a background task in the shell with the
  83.         RUN or RUNBACK command.
  84.  
  85.         At each start the program looks for the configuration file named
  86.         "TZConfig" which must be placed in the "S:" directory.
  87.         If there exists no configuration file or the file contains bad
  88.         data, "Twilight Zone" opens its control panel showing the
  89.         standard configuration.
  90.         The control panel consists of following elements:
  91.  
  92.         * "Blanker modules" list *
  93.  
  94.         This list contains all blanker modules which could be found at the
  95.         start of the program. All blankers have the extension ".tz" except
  96.         the built-in module "SimpleBlank", which is the default blanker.
  97.         Whenever no blanker module is available or the blanker specified
  98.         in the configuration file cannot be found, "SimpleBlank" will be
  99.         selected automatically.
  100.  
  101.         * "Sleep delay" adjusting *
  102.  
  103.         The time out period can be adjusted by a counter gadget and a
  104.         cycle gadget, which toggles between seconds and minutes.
  105.  
  106.         * "Blank now" corner *
  107.  
  108.         This mutual exclusive gadget allows you to specify a corner of
  109.         the screen. If the mouse pointer is moved into this corner,
  110.         "Twilight Zone" will blank the screen immediately.
  111.  
  112.         * "Blank never" corner *
  113.  
  114.         This mutual exclusive gadget allows you to specify a corner of
  115.         the screen. If the mouse pointer is moved into this corner,
  116.         "Twilight Zone" will never blank the screen, unless you move the
  117.         pointer away from this corner.
  118.  
  119.         * "When to wake" flags *
  120.  
  121.         When a blanker module is activated, "Twilight Zone" waits for a
  122.         event from the user. This event may be a key stroke, a mouse
  123.         movement or insertion or ejection of a disk.
  124.         There are existing three check boxes for these events, which may
  125.         be combined individually.
  126.  
  127.         * Button "About..." *
  128.  
  129.         Click this button to get short information about "Twilight Zone".
  130.  
  131.         * Button "Show" *
  132.  
  133.         If you click this button, "Twilight Zone" will activate the
  134.         currently selected blanker module.
  135.         (This is a feature I am missing in most blankers ! The action part
  136.         is the one and only interesting feature of a screen blanker. Thus
  137.         I find it stupid to force the user to activate the blanker and then
  138.         to wait a few seconds before he can watch the action part !)
  139.  
  140.         * Button "Use" *
  141.  
  142.         If you click this button, "TwilightZone" will save the current
  143.         settings to its configuration file and then install the last
  144.         selected blanker module.
  145.         You can then return to the control panel by pressing the hot key
  146.         kombination RIGHT ALT + RIGHT SHIFT + ESC.
  147.  
  148.         * Button "Quit" *
  149.  
  150.         Click this button to quit from "Twilight Zone".
  151.  
  152.  
  153.  
  154.         ***************************************************************
  155.  
  156.  
  157.         3. Creating own blanker modules
  158.  
  159.  
  160.         In the following section I give a brief description how to
  161.         create own blanker modules. For this work you need some advanced
  162.         knowledge in Assembler programming.
  163.  
  164.         Each blanker module has the following structure:
  165.  
  166.         ********** blanker header **********
  167.  
  168.         0x00  dc.l "TWILIGHTZONE" (12 bytes)
  169.         0x0C  dc.l LocationID     (4 bytes)
  170.  
  171.         ********** blanker module **********
  172.  
  173.       ->0x10  bra  StartBlanker   (4 bytes)
  174.       ->0x14  bra  StopBlanker    (4 bytes)
  175.         0x18  ...
  176.  
  177.         The "LocationID" the following meaning:
  178.  
  179.         1. Most significant bit (MSB, Bit 31) not set:
  180.  
  181.         load blanker to the specified absolute address (if you want
  182.         to use a lamer-intro as a blanker module :-( ).
  183.  
  184.         2. Most significant bit (MSB, Bit 31) set:
  185.  
  186.         2.1 Last significant bit (LSB, Bit 0) not set:
  187.  
  188.         Load blanker to an arbitrary address (normal case :-) ).
  189.  
  190.         2.2 Last significant bit (LSB, Bit 0) set:
  191.  
  192.         Load blanker to an arbitrary address in chip memory (if your
  193.         blanker module uses graphical data).
  194.  
  195.         The pure blanker code itself is all the (relocatable assembly)
  196.         code starting from 0x18 until the end of file.
  197.         The code starting at "StartBlanker" has the task to blank the
  198.         screen or to install an interrupt service routine or to do
  199.         something else. The initialization code must be terminated by a
  200.         RTS command.
  201.         The code starting at "StopBlanker" resets the screen display
  202.         and must also end with a RTS command.
  203.  
  204.  
  205.         ***************************************************************
  206.  
  207.  
  208.         If you find any bugs or you have any ideas how to improve this
  209.         this product, then contact me:
  210.  
  211.               ///   Rainer Koppler
  212.              ///    Stelzhamerstraße 9
  213.         \\\ ///     A-4623 Gunskirchen
  214.          \\X//      Austria/Europe
  215.  
  216.         internet: rainer@soft.uni-linz.ac.at
  217.